home *** CD-ROM | disk | FTP | other *** search
/ InterCD 2000 September / september_2000.iso / intercd / root / ^Linux / cfengine-1.5.3 / README-1.5.x < prev    next >
Encoding:
Text File  |  1999-08-12  |  5.1 KB  |  143 lines
  1. This version of cfengine focusses on security and
  2. efficiency. Several new features have been added to network
  3. communication by cfd:
  4.  
  5.  * Encrypted transfers
  6.  * Better authentication (by user)
  7.  * More efficient transfers over single connection
  8.  
  9. Other things like Tripwire functionality for md5 checksums
  10. has been added for convenience.
  11.  
  12. * Regular expression libraries use Posix extended regular expressions.
  13.   This means that you might have to make changes to escape characters
  14.   in your configuration files in order for them to run.  
  15.  
  16. * User authentication based on pidentd and key exchange for secure lines
  17.  
  18. * Allow DES-encrypted communication between client and server.  
  19.  
  20. * Remote copy protocol semantics will are not compatible with 1.4.x, 
  21.   owing optimizations which should improve performance on large transfers.  
  22.  
  23. * This version also works on NT, using the cygwin-32
  24.   libraries available from http://www.cygnus.com
  25.  
  26.  
  27. Upgrading
  28. ----------
  29.  
  30. Please be careful installing this version of cfengine, even if you
  31. have been following the beta versions. There are changes in threading
  32. policy and protocol which make remote file transfers much more
  33. efficient and reliable with cfd. The new threading policy makes
  34. it impossible to support the old protocol simultenously. If you rely
  35. on cfd for all copying, then upgrading should be done with caution.
  36. If you only have a few hosts, upgrading by hand should not be
  37. difficult, but if you have many, you might want to think about this:
  38. Here are some hints for a safe upgrade.
  39.  
  40.  * Copy the new cfengine files to NEWcfengine NEWcfd NEWcfrun
  41.    and make sure that they are all copied to every host before
  42.    running them.
  43.  
  44.  * At some time of day or night when no remote copying is taking
  45.    place, use a process command in cfengine to kill the old
  46.    cfd, then move the NEW files to cfengine, cfd and cfrun
  47.    and restart cfd.
  48.  
  49. This should take care of all hosts which are alive. If any hosts
  50. are down, they will not be upgraded and they will not be able
  51. to speak to cfd when they come up again, unless they read
  52. cfengine from an NFS server.
  53.  
  54. NT
  55. --
  56.  
  57. The port to NT has been done with my two students: Bjoern Gustafson
  58. and Joergen Kjensli.
  59.  
  60. Cfengine 1.5.0 will compile and run on Windows NT, if you
  61. have the cygwin32 Free Software installed. Some documentation
  62. about the port will be available soon, including tips on
  63. the configuration of cygwin.
  64.  
  65. Cfengine can set ACLs on files, but will not work
  66. correctly on directories yet. This will be fixed
  67. shortly, a long with some reasonable documentation.
  68.  
  69. We have not had sufficient opportunity to test cfengine
  70. on NT, at the College, since we do not use NT for any real
  71. tasks, so please treat this as beta quality software and
  72. work somewhat defensively. It should be possible for us
  73. to test it more next year.
  74.  
  75. Regular expressions
  76. -------------------
  77.  
  78. As of 1.5.0 cfengine requires a posix regular expression library.
  79. In most modern systems this will work automatically, but on old legacy
  80. systems it might cause problems compiling. If your host does not
  81. support regcomp() and regexec(), regex.h, you should collect
  82. the GNU regular expression library (excerpted from the C library) 
  83.  
  84.  rx-1.5.tar.gz
  85.  
  86. or later. This should cure the problem. 
  87.  
  88. On solaris machines I have experienced trouble
  89. with header files getting mixed up. rxposix.h and regex.h.
  90. You should probably not install the GNU library on a solaris
  91. machine, where the regex library seems to work well.
  92.  
  93. On NT with the cygwin32 library, it was necessary to compile
  94. GNU librx on the system. The existing regex functions compiled
  95. but did not work.
  96.  
  97. DES Encryption
  98. ---------------
  99.  
  100. You can arrange to encrypt transferred files by symmetric
  101. cipher, if you have the OpenSSL libraries installed,
  102. or a later version (now called OpenSSL http://www.OpenSSL.org).
  103. The secure=true option instigates encrypted transfer.
  104. A new program cfkey can be used to generate a key file on one
  105. host.
  106.  
  107. cfkey > /var/run/cfengine/keys
  108.  
  109. or 
  110.  
  111. cfkey > /etc/cfengine/keys
  112.  
  113. This same file must then be distributed to all participating hosts.
  114. The server can REQUIRE hosts to perform encrypted transfer with
  115. secure=true in cfd.conf.
  116.  
  117. AIX and pthreads
  118. ----------------
  119.  
  120. AIX prior to 4.2 does not have a POSIX correct version of the pthread
  121. library. Although the threading support should work now on AIX 4.2,
  122. the reliability of the daemon in mulitithreaded mode might not be
  123. optimal. Signal support is not handled properly, so the daemon might
  124. terminate badly.
  125.  
  126. Known bugs
  127. ----------
  128.  
  129.  For some reason, cfd seems to hang when copying itself from
  130.  one host to another, on solaris.
  131.  
  132.  The handling of the network interface has grown increasingly
  133.  difficult. Apart from the fact the internet sockets and ioctl
  134.  calls are amongst the ugliest, actually disgusting, APIs I have
  135.  ever encountered, many OSes are going over to routing sockets
  136.  which I do not know anything about, so this will have to wait.
  137.  
  138.  If anyone who understands the new route structures for routing
  139.  sockets would like to send me a patch to read and set routes
  140.  netmasks and brodcast addresses, I would be for ever grateful.
  141.  
  142. Mark
  143.